home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / libdl / dlerror.z / dlerror
Encoding:
Text File  |  1998-10-30  |  2.8 KB  |  67 lines
  1.  
  2.  
  3.  
  4. DDDDLLLLEEEERRRRRRRROOOORRRR((((3333CCCC))))                                                        DDDDLLLLEEEERRRRRRRROOOORRRR((((3333CCCC))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ddddlllleeeerrrrrrrroooorrrr - get diagnostic information
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      cccccccc [ffffllllaaaagggg ...] ffffiiiilllleeee ...  ----llllcccc [lllliiiibbbbrrrraaaarrrryyyy ...]
  13.  
  14.      ####iiiinnnncccclllluuuuddddeeee <<<<ddddllllffffccccnnnn....hhhh>>>>
  15.  
  16.      cccchhhhaaaarrrr ****ddddlllleeeerrrrrrrroooorrrr((((vvvvooooiiiidddd))));;;;
  17.  
  18. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.      ddddlllleeeerrrrrrrroooorrrr returns a null-terminated character string (with no trailing
  20.      newline) that describes the last error that occurred during dynamic
  21.      linking processing. If no dynamic linking errors have occurred since the
  22.      last invocation of ddddlllleeeerrrrrrrroooorrrr, ddddlllleeeerrrrrrrroooorrrr returns NNNNUUUULLLLLLLL.  Thus, invoking ddddlllleeeerrrrrrrroooorrrr
  23.      a second time, immediately following a prior invocation, results in NNNNUUUULLLLLLLL
  24.      being returned.
  25.  
  26. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  27.      ddddlllleeeerrrrrrrroooorrrr(3), ddddllllooooppppeeeennnn(3), ssssggggiiiiddddllllaaaadddddddd(3), ssssggggiiiiddddllllooooppppeeeennnn____vvvveeeerrrrssssiiiioooonnnn(3), ddddllllssssyyyymmmm(3).
  28.  
  29. NNNNOOOOTTTTEEEESSSS
  30.      The messages returned by ddddlllleeeerrrrrrrroooorrrr may reside in a static buffer that is
  31.      overwritten on each call to ddddlllleeeerrrrrrrroooorrrr.  Application code should not write
  32.      to this buffer.  Programs wishing to preserve an error message should
  33.      make their own copies of that message.
  34.  
  35.      The string pointed to by the return value must not be _f_r_e_e(3)d.
  36.  
  37.      The ddddlllleeeerrrrrrrroooorrrr string space is not thread-safe (whether _s_p_r_o_c(2) threads
  38.      with shared data or POSIX-pthreads or some other shared-data thread
  39.      code):  multiple threads doing dynamic linking calls can step on each
  40.      others ddddlllleeeerrrrrrrroooorrrr strings.
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.